home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / Tele / I-L / Kermit Tool GH Folder / READ_ME_PLEASE < prev   
Encoding:
Text File  |  1992-08-29  |  4.1 KB  |  100 lines  |  [TEXT/Rich]
  1. Kermit Tool GH version 1.0
  2. by  Glenn R. Howes -- University of Wisconsin Department of Chemistry
  3.  
  4.  
  5. What it is:
  6.  Kermit Tool GH is a freeware file transfer tool for use with  
  7.  programs that utilize the Macintosh Communications Toolbox.
  8.  
  9. How to use it:
  10.  1) Get a CTB compliant application. Examples would be ClarisWorks,
  11.  Termy,VersaTerm etc. 
  12.  (***Warning: VersaTerm 4.6.2 has a bug in it that causes freezes 
  13.  with all CTB file transfer tools using some CTB connection tools 
  14.  (ex: Serial Tool, Powerbook Modem Tool).***)
  15.  2) Install the basic CTB set. (this is available from Apple).
  16.  3) Place Kermit Tool GH in either the extensions folder (sys 7) or
  17.  the communications folder (sys 6).
  18.  
  19. What it does:
  20.  Right now, it implements a Kermit file transfer protocal
  21.  with packet size <= 9025 (given enough memory), 1 or 2 byte error 
  22.  checking, run compression, text file or binary file sends 
  23.  In text mode it strips out line feeds while receiving, and adds 
  24.  them while transmitting and doesn't worry about parity.
  25.  
  26.  In the near future it will support extra long packet lengths,
  27.  and 3-byte error checking. It should also handle transmission errors 
  28.  with more grace. I am also looking at the extensions in CTB 1.1
  29.  which support sending and receiving multiple files (this tool
  30.  can already receive multiple files on its own), and Kermit server
  31.  mode.
  32.  
  33.  In the distant future it will support packet windowing, and all the
  34.  international localization schemes that Apple wants implemented.
  35.  Of course, if someone at DTS would like to send me some sample code
  36.  showing how to do this, it would get done that much faster.
  37.  
  38. Performance:
  39.  If you find that running this tool in the background is slowing 
  40.  down your machine too much, reduce the packet length. Alternatively,
  41.  if you want faster transfer speed increase the packet length
  42.  (1024 is a good value if the remote kermit supports it). I think my
  43.  implementation is quick compared to other implementations of Kermit.
  44.  Know that some minimal implementations of Kermit support packet 
  45.  lengths of 94 or less.
  46.  If a transfer stops dead, try cancelling and dropping the packet 
  47.  length by a few below the maximum supported by the remote Kermit.
  48.  Using run length compression (default) might give a noticeable
  49.  increase in throughput, especially for text files.
  50.  Use 8 bit lines if at all possible, especially for binary files.
  51.  
  52. Testing:
  53.  I've had several people beta test this tool, they found several errors
  54.  and made many interface suggestions which I have incorporated into
  55.  this tools design. This does not mean there are no bugs, just that
  56.  I squashed the more obvious ones. You should see the bottom of my
  57.  shoes.
  58.  
  59. Distribution:
  60.  Feel free to distribute this tool with this Read Me file. However, 
  61.  this tool is not to be sold or bundled with any shareware or 
  62.  commercial software without my express consent.
  63.  
  64. Legalisms:
  65.  I retain all rights to this tool and to its source code.
  66.  
  67.  I neither give nor imply any warranty of this product. Bugs are
  68.  unavoidable in software development, so any loss of data or
  69.  time caused by this tool is not my responsibility. Besides,
  70.  what did you pay for this tool. :-)
  71.  
  72. Thank You:
  73.   John Scott for rewriting the 'fcsr' segment in his own image
  74.   Brad Spencer and Ed Turner for lending me needed books
  75.   Frank da Cruz for writing "Kermit: A File Transfer Protocol"
  76.   Pete Resnick and John Rawnsley for their extra help in beta.
  77.   Symantec for selling a beautiful C compiler (Think C 5.0)
  78.   My mother for having me and 9 other children.
  79.  
  80. In the unlikely event you care:
  81.   My birthday is May 19th, and my favorite presents are cash,
  82.   shrink wrapped software and expensive computer equipment.
  83. -------------------------------------------------------------------
  84. The enclosed communication toolbox tool is an early release
  85. version. If you find a serious bug, please catalog:
  86. how they occured,
  87. what equipment (computer),
  88. system software,
  89. application software,
  90. communication setup (parity, data bits, speed....),
  91. anything else that appears appropriate,
  92. your e-mail address if you have one
  93.  
  94. Glenn Howes
  95. Room #3211
  96. 1101 University Ave. 
  97. Madison,WI 53706
  98. -------------------------------------------------------------------
  99. version history:
  100. initial release 1.0